home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 001a / cmread11.zip / CMREADER.DOC < prev    next >
Text File  |  1991-12-05  |  14KB  |  531 lines
  1.  
  2.  
  3.                ██▒▒██▒▒██▒▒██▒▒             ChessMAGIC!
  4.                ▒▒██▒▒██▒▒██▒▒██         Offline Game Reader
  5.                ██▒▒██▒▒██▒▒██▒▒                v1.1
  6.                ▒▒██▒▒██▒▒██▒▒██               (c)1991
  7.                ██▒▒██▒▒██▒▒██▒▒        Knightware/Bud Bradley
  8.                ▒▒██▒▒██▒▒██▒▒██
  9.                ██▒▒██▒▒██▒▒██▒▒         in association with
  10.                ▒▒██▒▒██▒▒██▒▒██             Decibel BBS
  11.  
  12.  
  13.  
  14.  
  15.                                 REFERENCE MANUAL
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.                                  Distributed by
  26.  
  27.                                    KnightWare
  28.                                465 Ridgedale Way
  29.                            Lawrenceville, GA   30244
  30.                                  (404) 978-2893
  31.  
  32.                                   Decibel BBS
  33.                                   Atlanta, GA
  34.                                 Tom Brady, Sysop
  35.                      (404) 288-6858   1200/2400/9600 (HST)
  36.                      (404) 284-1152   1200/2400  (MNP/V42)
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.                     Copyright (c)1991 Bud Bradley/KnightWare
  54.                               All Rights Reserved 
  55.  
  56.  
  57.                                    INTRODUCTION 
  58.  
  59.     
  60.     The ChessMAGIC! Offline Game Reader (e.g. CMReader) is FREE for all chess 
  61.     enthusiasts to use and enjoy.  However, the program remains copyrighted 
  62.     and is the sole property of KnightWare (Bud Bradley).  The complete 
  63.     CMReader archive may be freely distributed as long as the contents remain 
  64.     intact and without modification. 
  65.      
  66.     CMReader provides the means to play back and study any chess game from a 
  67.     simple text format file.  The main benefits of CMReader, though, are 
  68.     derived when used in conjunction the BBS door ChessMAGIC! (registered 
  69.     versions).  Registered ChessMAGIC! versions enable users to download 
  70.     games matching many and varied criteria for later offline study at their 
  71.     leisure. 
  72.     
  73.  
  74.                                  W A R R A N T Y
  75.  
  76.     Users of the ChessMAGIC! Offline Game Reader (e.g. CMReader) must accept 
  77.     this disclaimer of warranty: 
  78.     
  79.     "CMReader is supplied as is.  The author disclaims all warranties, 
  80.     expressed or implied, including, without limitation, the warranties of 
  81.     merchantability and of fitness for any purpose. The author assumes no 
  82.     liability for damages, direct or consequential, which may result from the 
  83.     use of CMReader. 
  84.  
  85.     "In no event shall KnightWare be liable for any damages, including lost 
  86.     profits, lost savings or other incidental or consequential damages 
  87.     arising out of your use or inability to use CMReader, or for any claim by 
  88.     any other party. 
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.                                   - i -
  114.  
  115.  
  116.                      T a b l e    o f    C o n t e n t s
  117.  
  118.        Section    Title                                     Page
  119.  
  120.          1.0      SYSTEM REQUIREMENTS                        1
  121.  
  122.          2.0      CMSHELL {CMReader Front End}               1
  123.  
  124.          3.0      INITIALIZATION                             2 
  125.  
  126.          4.0      COMMAND OPTIONS                            2 
  127.  
  128.          5.0      GAME FILE FORMAT                           3
  129.          5.1        Rules & Guidelines                       3
  130.  
  131.          6.0      PRODUCT SUPPORT                            6 
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.                                   - Page ii -
  173.  
  174.  
  175. ------------------------------------------------------------------------------
  176. 1.0    CMReader -- SYSTEM REQUIREMENTS
  177. ------------------------------------------------------------------------------
  178.  
  179.        PC/MS-DOS 2.11 or higher
  180.        360k Floppy Drive
  181.        185k RAM Minimum
  182.        Hercules Graphics with B/W or CGA monitor
  183.  
  184. ------------------------------------------------------------------------------
  185. 2.0    CMSHELL  {CMReader Front End}   
  186. ------------------------------------------------------------------------------
  187.  
  188.        CMShell should be run first, as the CMReader front end and will make 
  189.        game viewing an easy operation!  Even though you can still run 
  190.        CMreader all by itself, CMShell provides you with simple menu 
  191.        displays of available games.  The command line would be: 
  192.        
  193.           CMSHELL 
  194.        
  195.        When run, a full-screen menu will show all available games (default 
  196.        extension of 12 and default current logged directory) and the 
  197.        associated players.  Once you've chosen a game to view, CMReader will 
  198.        be run with that game.  After exiting CMReader, you will return to 
  199.        CMShell for more choices. 
  200.        
  201.        There are several command keys available in CMShell: 
  202.        
  203.            <F1>     =  Prompts for up to 3 character game file extension 
  204.                        (defaults to 12 -- notice, no periods). 
  205.            <F2>     =  Prompts for drive/directory in case you keep games 
  206.                        organized in various areas. 
  207.            <F3>     =  Toggles between short/long game descriptions. 
  208.  
  209.            <PgUp>   =  Scrolls back one screen at a time (if many games). 
  210.          
  211.            <PgDown> = Scrolls forward one screen at a time (if many games). 
  212.        
  213.            <ESC>    = CMShell exit 
  214.        
  215.     
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.                                   -Page 1-
  232.  
  233.  
  234. ------------------------------------------------------------------------------
  235. 3.0    CMReader -- INITIALIZATION
  236. ------------------------------------------------------------------------------
  237.  
  238.        In order to operate CMReader manually (i.e. WITHOUT using CMShell), 
  239.        you must specify a file name on the command line for it to use.  The 
  240.        specified file MUST be in the proper format (discussed later) in 
  241.        order for CMReader to operate correctly. Using the included sample 
  242.        file, your command line would be: 
  243.  
  244.            cmreader 69.12
  245.  
  246.        The sample game file was generated by a registered ChessMAGIC! system.
  247.        While you may name your files anything you like, ChessMAGIC! will
  248.        always name them by game number:
  249.     
  250.            69.12        <--  Game Number = 69
  251.     
  252.        The file extension used/generated by ChessMAGIC! is a random pattern
  253.        for its own internal use.
  254.  
  255. ------------------------------------------------------------------------------
  256. 4.0    CMReader -- COMMAND OPTIONS
  257. ------------------------------------------------------------------------------
  258.  
  259.        Function Keys-
  260.  
  261.            <F1> = HELP Screen
  262.            <F2> = Invert Board
  263.            <F3> = Auto-Play ON/OFF Toggle (approximately 1 move per second)
  264.      
  265.        Cursor Keys-
  266.  
  267.            Right Arrow = Next Move
  268.            Left  Arrow = Take Back Move
  269.            <HOME>      = Reset board to 1st move, clearing all Marked moves
  270.  
  271.        Miscellaneous-
  272.  
  273.            <SPACEBAR>  = Mark Move Numbers
  274.          * <ALT-X>     = Clear all Marked Moves
  275.          * <ALT-J>     = Jump to next Marked Move
  276.  
  277.          * <ALT-G>     = Goto Specified Move Number
  278.  
  279.            <ESC>       = Exit CMReader and return to DOS
  280.  
  281.          * Denotes holding down the <Alt> key and pressing the associated
  282.            letter.
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.                                   -Page 2-
  292.  
  293.  
  294. ------------------------------------------------------------------------------
  295. 5.0    CMReader -- GAME FILE FORMAT
  296. ------------------------------------------------------------------------------
  297.  
  298.        The file MUST be in standard ASCII text form and contain NO embedded
  299.        control codes, extended ASCII characters, etc.  Refer to your word
  300.        processor or text editor documentation on how to generate this type of
  301.        file.
  302.  
  303.        Only ONE game per file and the contents would be similar to the
  304.        following example of a partial game:
  305.     
  306.            #White:Darrell                (1711) 
  307.            #Black:Other Brother Darrell  (1305) 
  308.            # Date:11/06/91
  309.            1. f2-f4  b8-c6
  310.            @This is a non-displayed comment.
  311.            2. g1-f3  g8-f6
  312.            $This is a Black-Side comment
  313.            $and can be up to
  314.            $3 lines of 79 characters each.
  315.            3. b2-b3  f6-d5
  316.            #This is a White-side comment
  317.            #and can be up to
  318.            #3 lines of 79 characters each.
  319.  
  320. ------------------------------------------------------------------------------
  321. 5.1    CMReader -- Game File Format Rules & Guidelines
  322. ------------------------------------------------------------------------------
  323.  
  324.        Comment Lines-
  325.  
  326.                @ = invisible (never displays)
  327.                # = Display After White-side Move
  328.                $ = Display After Black-side Move
  329.  
  330.            Comments may be up to 79 characters per line with a maximum of 3
  331.            contiguous lines prior to a move entry.  A comment character must
  332.            be placed in the first column for it to be recognized as such by
  333.            CMReader.
  334.  
  335.         Notation-
  336.  
  337.                Long Algebraic       :   e2-e4
  338.                Semi-Short Algebraic :   e4    Nf6    Qxc4
  339.            
  340.            Although the program accepts and interprets semi-short algebraic
  341.            notation, the display will be in long algebraic form.
  342.            
  343.        
  344.        
  345.        
  346.        
  347.        
  348.        
  349.        
  350.                                   -Page 3-    
  351.  
  352.  
  353. ------------------------------------------------------------------------------
  354. 5.1    CMReader -- Game File Format Rules & Guidelines  {continued}
  355. ------------------------------------------------------------------------------
  356.  
  357.         Move Separator-
  358.            
  359.            These can be any of the following:
  360.            
  361.                e2-e4   e2;e4   e2xe4
  362.             
  363.            The x is normally only used to designate captures. 
  364.  
  365.         Move Numbers-
  366.  
  367.            Each White/Black move pair MUST either have a line to themselves, 
  368.            or they can be followed by additional White/Black move pairs.  
  369.            Whichever way you choose, they MUST BE IN White/Black PAIRS and a 
  370.            Move Number MUST be in the first column:
  371.            
  372.                Correct-
  373.            
  374.                      1 e2-e4  g7-g6
  375.                   or
  376.                      1.e2-e4  g7-g6
  377.                   or
  378.                      1.e2-e4  g7-g6  2.d2-d4  f8-f7  3.g1-f3  d7-d6
  379.  
  380.                Incorrect-
  381.  
  382.                      1 e2-e4
  383.                      g7-g6
  384.                   or
  385.                      e2-e4
  386.                      g7-g6
  387.                   or
  388.                      23.
  389.            
  390.            The last incorrect example shows a move number that lacks a 
  391.            corresponding move entry.
  392.  
  393.            Note: The "." (i.e. period) is ignored by CMReader, so can either 
  394.            be included or excluded, whichever you prefer. 
  395.             
  396.  
  397.         Result Designation-
  398.  
  399.                Draw         =   0-0 or draw
  400.                Resignation  =   1-0 or 0-1 or resig
  401.                Mate         =   1-0 or 0-1 or mate
  402.            
  403.            Examples: 
  404.            
  405.                23.c1-e1 draw   or   23.c1-e1 0-0
  406.                23 c1-e1 resig  or   23 c1-e1 1-0  or  23 c1-e1 0-1
  407.                23.c1-e1 mate   or   23 c1-e1 1-0  or  23.c1-e1 0-1
  408.  
  409.  
  410.  
  411.  
  412.                                   -Page 4-
  413.  
  414.  
  415. ------------------------------------------------------------------------------
  416. 5.1    CMReader -- Game File Format Rules & Guidelines  {continued}
  417. ------------------------------------------------------------------------------
  418.            
  419.         Pawn Promotion-
  420.  
  421.                =Q   Queen
  422.                =R   Rook
  423.                =N   Knight
  424.                =B   Bishop
  425.  
  426.            The promotion is designated immediately following the move.  
  427.            Example, promoting a Pawn to a Queen:
  428.            
  429.                23.g7-g8=Q
  430.            
  431.         Exclamatory Signs-
  432.  
  433.                +    !    ?
  434.            
  435.            White and Black moves can contain up to 3 signs each, as shown:
  436.            
  437.                15 QxR+!?
  438.  
  439.         Castling-
  440.  
  441.            May be entered as either long algrebraic or the following, using 
  442.            capital O's: 
  443.            
  444.                O-O    = King-side 
  445.                O-O-O  = Queen-side 
  446.  
  447.            Examples:
  448.            
  449.                18.O-O  O-O-O
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.                                   -Page 5-
  472.  
  473.  
  474. ------------------------------------------------------------------------------
  475. 6.0    PRODUCT SUPPORT
  476. ------------------------------------------------------------------------------
  477.  
  478.        Questions or inquiries can be directed to us through any of the 
  479.        following sources:
  480.  
  481.                               * E-MAIL CONTACTS * 
  482.                                       and
  483.                            All BBS-Related Questions
  484.  
  485.                                    Decibel BBS 
  486.                                   (Atlanta, GA) 
  487.                        (404) 288-6858  1200-9600     (HST) 
  488.                        (404) 284-1152  1200-2400 (MNP/V42) 
  489.  
  490.  
  491.                                * VOICE CONTACTS * 
  492.  
  493.                                    KnightWare
  494.                            Bud Bradley : 404-978-2893
  495.  
  496.                                 The Decibel Group
  497.                            Tom Brady   : 404-284-9017 
  498.  
  499.        Note:  You will get answering systems at either voice number when 
  500.               nobody is available to personally take your call. 
  501.               
  502.  
  503.                                    * US MAIL * 
  504.  
  505.                                    KnightWare
  506.                                 465 Ridgedale Way 
  507.                             Lawrenceville, GA   30244 
  508.  
  509.                                 The Decibel Group
  510.                                   P.O. Box 1773
  511.                             Decatur, GA   30031-1773
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.                                   -Page 6-
  531.